概览与准备

1. 文档定位

本文档旨在帮助中小学生及教育工作者快速掌握 SIoT 的使用方法,包括安装、启动、基础操作及应用实践,助力用户理解物联网原理,并开展创意项目开发。

2. 什么是 SIoT

SIoT 是一个为教育场景定制的跨平台开源 MQTT 服务器程序。它的核心特点是“尽量降低搭建门槛”,让教师和学生可以在普通电脑、行空板等设备上,快速建立一个可用的物联网消息中心。

siot图标

其中:

  • S 可以理解为 Science 和 Simple。

  • IoT 指 Internet of Things,也就是物联网。

SIoT 的典型作用是充当“消息中转站”:

  • 主控板把传感器数据发给 SIoT。

  • 其他主控板、可视化面板再从 SIoT 读取这些数据。

  • 用户也可以通过网页向设备发送控制指令。

SIoT 的典型作用是充当消息中转站

3. 为什么在教学中使用 SIoT

和通用云平台相比,SIoT 更适合课堂或实验室里的本地教学:

  • 启动快:下载、解压、运行即可使用。

  • 要求低:不需要先购买云服务,也不需要搭服务器。

  • 反馈直观:学生能立刻看到消息发送、接收和控制效果。

  • 适合项目化学习:Topic 命名简单,便于按“项目/设备”组织数据。

  • 便于实验留痕:消息记录可以在网页中查看和导出。

4. SIoT 可以做什么

借助 SIoT,可以较为轻松地搭建一个基础的物联网应用系统。常见用途主要包括以下几类:

1. 数据采集:支持将温度、湿度、光照、空气质量等传感器数据上传到服务器统一记录。

2. 远程控制:可通过网页、MQTT 工具、其他主控板或可视化面板,向设备发送控制指令。

3. 数据可视化展示:可配合 Mind+ 数据可视化面板,实现数据实时显示、图表展示与设备控制。同时,也支持通过 Python 代码直接连接 SIoT,实现数据上传与远程控制。

4. 课堂实验与创意项目:适用于智能教室、环境监测、智慧农业、互动装置及科学实验记录等教学场景。
SIoT 可以做什么

5. SIoT 的工作方式

理解 SIoT 最简单的方式,是把它看作一个“局域网里的消息服务站”:运行 SIoT 的电脑或行空板负责收发消息,路由器负责把同一网络中的设备连接起来,主控板通过 Wi-Fi 或网线接入网络,电脑、手机、平板等终端可以通过浏览器访问 Web 管理页,也可以通过 MQTT 客户端或 Python 代码直接收发消息,是否连接互联网不是必须条件,只要局域网能互通,SIoT 就能工作。

siot工作方式

6. 适用环境

  • 操作系统:Windows / macOS / Linux

  • 主控板:行空板、micro:bit、Arduino、掌控板

  • 配套软件:Mind+(1.8.0 及以上)(教程中使用的是 Mind+ V2)

备注
本文教程中使用的是 Mind+ V2。关于 Mind+ V2 的具体使用方法,可参考:Mind+ V2 官方文档

7. 默认连接信息

在没有修改配置的情况下,可先按以下信息理解和测试;如果使用的是定制版本或已经修改过配置,请以实际环境为准:

  • MQTT 端口:1883

  • Web 管理端口:8080

  • 默认用户名:siot

  • 默认密码:dfrobot

  • Topic 格式建议:项目名/设备名

8. 版本说明

本文档默认以 SIoT V2.x 的使用方式为主线,涉及 SIoT V1 与 SIoT V2 差异时会单独说明。

这样安排的原因是:

  • SIoT V2 与当前教学案例、Mind+ 数据可视化面板、行空板应用场景衔接更紧密。

  • SIoT V1 中的一些基础概念、Topic 规则和使用思路仍然具有参考价值。

如果某一功能在不同版本中的入口、按钮名称或行为不同,文中会以“版本提示”的方式标出。

版本说明

快速入门

1. 使用前准备

开始之前,请先确认:

  • 你已经获得对应系统的 SIoT 软件包。

  • 运行 SIoT 的设备和主控板在同一局域网内。

  • 如果你计划让手机、平板或其他电脑访问 Web 页面,这些设备也需要接入同一网络。

使用准备

2. 下载与启动

2.1 下载软件

请根据实际设备和操作系统下载对应版本的 SIoT 软件包。下载完成后解压,即可看到对应平台的启动文件。

目前常见的 SIoT 版本主要分为 V1 和 V2。对于大多数当前教学场景,优先推荐 SIoT V2;如果需要兼容更多系统环境,可再考虑 SIoT V1。

版本 V1:

版本 V2:

重要警告
目前 SIoT V2.x 版本仅支持 Windows 操作系统。

2.2 启动 SIoT

这一部分主要介绍三种最常见的启动方式:

  • 在 Windows 上启动 SIoT V1

  • 在 Windows 上启动 SIoT V2

  • 在行空板 M10 上启用或运行 SIoT

如果只是临时测试,可以直接在 Windows 上运行;如果你准备长期用于课堂、可视化大屏或联网项目,推荐优先考虑在行空板 M10 上运行。

在 Windows 上启动 SIoT V1

如果你使用的是 SIoT V1,解压后双击运行 SIoT_windows1.2.exe。启动后会出现一个命令行窗口,请不要关闭。

在 Windows 上启动 SIoT V1

在 Windows 上启动 SIoT V2

如果你使用的是 SIoT V2,在 Windows 上的启动方式如下:

  1. 下载 Windows 版本的 SIoT V2 并解压。

  2. 双击运行 start SIoT.bat,启动后会弹出命令行窗口,用于启动新版 SIoT 服务。

重要警告
这里运行的是 start SIoT.bat,不是 main.exe。

在 Windows 上启动 SIoT V2

重要警告
如果需要让局域网中的其他设备访问 SIoT,还需要注意防火墙设置。建议在首次启动时,将 SIoT 添加到允许通过防火墙的应用中,并勾选专用网络和公用网络,否则外部设备可能无法访问。
防火墙设置

在行空板 M10 上运行 SIoT(推荐)

推荐直接在行空板 M10 上运行 SIoT 服务,其优势包括:

  • 不易受到 Windows 防火墙影响

  • 支持本地独立数据存储

  • 适合长时间稳定运行

  • 更适用于课堂教学与物联网可视化项目

当行空板系统版本为 v0.4.0 及以上时,可在本地 Web 管理页面中检查并确认已切换至 SIoT V2。关于如何在行空板 M10 上启用 SIoT 服务,请参考:行空板官方文档 - Home 菜单
在行空板 M10 上运行 SIoT(推荐)

如果系统版本低于 v0.4.0,则系统内置的是 SIoT V1,没有版本切换功能。这种情况下,需要先将内置的 SIoT V1 升级为 SIoT V2,升级方法可参考后续**进阶使用**中的相关章节。

3. 登录 Web 管理页面

SIoT 启动成功后,可以通过浏览器访问 Web 管理页面。根据运行环境不同,常见访问方式如下。若首次无法打开页面,建议先确认 SIoT 服务仍在运行,且启动窗口没有被关闭。

3.1 在本机电脑上访问

如果 SIoT 运行在当前这台电脑上,可在浏览器中输入:http://127.0.0.1:8080 或者 http://localhost:8080 ,这两种写法都表示访问当前电脑本机的 SIoT 服务。

在本机电脑上访问

成功进入登录页面后,输入 SIoT 的账号和密码,即可进入 SIoT Web 管理界面,进行 Topic 查看、消息测试和数据管理。

  • 默认用户名:siot

  • 默认密码:dfrobot

进入 SIoT Web 管理界面

3.2 在行空板 M10 上访问

如果 SIoT 运行在行空板 M10 上,常见访问方式是在浏览器中输入:http://10.1.2.3

进入行空板本地 Web 页面后,可以点击打开页面打开 SIoT 的登录页面。

在行空板 M10 上访问

如果你已经让行空板连接了无线热点,也可以直接通过无线网络中的 IP 地址(例如 192.168.1.46)访问其 Web 管理页面。关于如何连接无线热点以及如何查看网络 IP,可参考:行空板官方文档-Home 菜单与行空板官方文档-本地 Web 主页

在行空板 M10 上访问1

成功进入登录页面后,输入 SIoT 的账号和密码,即可进入 SIoT Web 管理界面,进行 Topic 查看、消息测试和数据管理。

  • 默认用户名:siot

  • 默认密码:dfrobot

进入 SIoT Web 管理界面

3.3 在局域网中的其他设备上访问

如果需要让手机、平板或其他电脑访问运行在当前电脑上的 SIoT,需要把地址改成这台电脑的局域网 IP 地址。例如下图电脑 IP 为 192.168.1.183,则手机或其他电脑可在浏览器中输入 192.168.1.183:8080。

在局域网中的其他设备上访问 在局域网中的其他设备上访问

成功进入登录页面后,输入 SIoT 的账号和密码,即可进入 SIoT Web 管理界面,进行 Topic 查看、消息测试和数据管理。

  • 默认用户名:siot

  • 默认密码:dfrobot

进入 SIoT Web 管理界面

使用在其他设备上访问时,需要同时满足下面几个条件:

  • 访问设备和运行 SIoT 的电脑在同一局域网内

  • SIoT 已经正常启动

  • Windows 防火墙已允许 SIoT 通过

如果手机或其他电脑无法打开该地址,通常需要优先检查:

  • SIoT 是否已经加入允许通过防火墙的应用列表

  • 两台设备是否连接到了同一个局域网。

  • 电脑当前使用的局域网 IP 是否填写正确

4. 第一次完成消息通信(基于 Mind+ 实时模式)

4.1 先确定 Topic

建议先创建一个简单的 Topic。以 SIoT V2 为例,在 Web 管理页面中输入设备名 test,平台会自动生成完整 Topic siot/test。

其中:

  • siot 表示项目名称,在 SIoT V2 中该项由平台固定生成,不能自定义。

  • test 表示设备名称,可以根据实际项目自定义。

在 SIoT 中,/ 用于分隔“项目”和“设备”两个层级。初学阶段建议尽量使用英文、数字或下划线命名,便于排错和跨平台使用。

先确定 Topic

重要警告
SIoT V1 通常是在程序端创建 Topic,而不是在 Web 页面中手动创建。如下图,程序运行并创建 Topic 后,对应内容会自动显示在 SIoT V1 的 Web 页面中。
先确定 Topic1

4.2 发送数据到 SIoT

接下来通过 Mind+ 实时模式向 SIoT 平台发送一条测试消息,例如 hello SIoT。如果没有特殊兼容需求,推荐优先使用 SIoT V2。

关于 Mind+ 其他模式下的使用方法,可参考后文“主控板接入指南”。

发送数据到 SIoT示意图

首先编写程序,并完成 MQTT 初始化参数设置。注意服务器地址、用户名、密码和 Topic 需要填写正确;程序运行后,再到 Web 页面查看数据。

代码

提示
在程序编写中,SIoT V1 和 SIoT V2 使用的发送消息积木不同,V2 积木上会标注 SIoT V2 字样。
SIoT V1 和 SIoT V2 使用的发送消息积木不同

4.3 到 Web 页面查看结果

回到 SIoT 的 Web 管理界面,在消息或设备相关页面中查看该 Topic 的记录。只要能看到刚刚发出的消息,就说明:SIoT 服务运行正常,网络连通正常,MQTT 参数填写正确,主题设置没有写错。
到 Web 页面查看结果示意图

4.4 测试反向控制

在 Web 页面的“发送消息”中,向同一 Topic 发送控制指令,例如 ON 或 OFF。在 Mind+ 实时模式中提前写好接收逻辑:当接收到 ON 时,舞台区显示或说“开灯”;当接收到 OFF 时,舞台区显示或说“关灯”。

到 Web 页面查看结果示意图 到 Web 页面查看结果示意图

5. SIoT 数据可视化

SIoT 支持与 Mind+ 数据可视化面板联动,可以实现:

  • 📊 实时数据展示(数值 / 图表)

  • 🎮 远程控制设备(按钮 / 开关)

  • 🧩 快速搭建物联网应用界面

关于 Mind+ 数据可视化面板的详细使用方法,请参考:Mind+ 数据可视化面板教程
数据可视化

SIoT Web 管理界面

1. SIoT V1 界面介绍

1.1 登录界面

SIoT V1 的登录界面比较直接,主要由 3 个位置组成:账号 与 密码 输入框,以及 登录 按钮。

  • 账号 输入框:填写登录用户名,默认通常为 siot

  • 密码 输入框:填写登录密码,默认通常为 dfrobot

  • 登录 按钮:提交账号信息并进入管理页面
    登录界面示意图

1.2 项目列表

登录后,通常先看到“项目列表”。这一页是进入 SIoT 数据管理的第一层入口,主要用于查看当前平台中已经存在的项目,并继续进入对应的设备层级。

项目列表

从界面上看,项目列表页通常由以下几个区域组成:

  • 顶部导航栏:可切换到“项目列表”“设备列表”“发送消息”等页面

  • 查询区域:可按项目 ID 检索项目,并设置每页显示数量

  • 数据表格区:显示当前已有的项目记录

  • 操作区:对项目执行查看、备注和删除等操作

其中,数据表格里常见的包括:

  • 项目ID:当前项目的名称

  • 备注:用于补充说明项目用途

  • 操作:提供进入下一级页面或管理项目的入口

在“操作”栏中,常见功能包括:

  • 查看设备列表:进入该项目下的设备页

  • 添加备注:为当前项目补充说明信息

  • 删除:删除当前项目记录

这一页特别适合按下面几种方式组织内容:

  • 按班级划分项目

  • 按实验主题划分项目

  • 按作品系统划分项目

对初学者来说,我们可以先把它理解成“项目总目录页”。先找到项目,再进入设备,再查看消息,这样更容易建立完整的操作路径。

1.3 设备列表

设备列表页会把当前记录过消息的 Topic 组织成更适合阅读的设备视图,并按时间从近到远排序,方便定位最近正在调试的设备。
设备列表示意图

在该页面中,可以完成以下操作:

  • 查看设备上传的数据

  • 添加或修改设备备注

  • 查看历史消息记录

  • 清理无效设备或测试数据

通过设备列表页面,用户可以快速了解当前项目中的设备组成及数据情况。

从当前界面来看,设备列表页通常包含以下信息:

  • 项目ID:设备所属的项目

  • 名称:设备名称,对应 Topic 中的设备部分

  • 备注:对设备用途进行补充说明

  • 操作:对设备进行查看和管理

在“操作”栏中,常见功能包括:

  • 查看消息:查看该设备上传的历史消息数据

  • 清空消息:删除该设备已有的消息记录

  • 删除设备:删除当前设备及其关联记录

  • 添加备注:为设备添加或修改说明信息

高危警告
清空消息和删除设备操作不可恢复,请谨慎使用。

因为 SIoT V1 通常采用 “项目/设备” 的 Topic 组织方式。

例如:siot/led、siot/temp、siot/light

其中:

  • siot 为项目名称

  • temp、light、led 为设备名称

因此,一个项目下可以包含多个设备,也可以对应多个 Topic。

建议先在“项目列表”中选择一个项目,再进入对应的“设备列表”页面查看设备数据,这样更容易理解 SIoT 中 项目 → 设备 → 消息数据 的组织结构。

项目
 ├── 设备A(temp)
 ├── 设备B(light)
 └── 设备C(led)
设备列表2

这种管理方式能够帮助用户对同一物联网项目中的多个设备进行统一管理和数据查看。

1.3.1 查看消息

“查看消息”是最常用的页面之一,因为它能把抽象的 MQTT 通信立刻可视化。
查看消息

这一页通常可以帮助用户:

  • 查看某个 Topic 的历史消息

  • 确认设备是否真的发出过数据

  • 通过 隐藏/显示图表 功能观察最近一段时间的数据变化

  • 用 导出查询结果 功能保留实验结果

从界面功能来看,这一页通常包括:
查看消息

  • 消息发送区域:可直接向当前 Topic 发送测试消息。
    发送消息

  • 时间筛选区域:可指定开始时间与结束时间查询消息。
    时间筛选

  • 条数设置区域:可选择每次显示的消息数量。
    条目设置

  • 导出查询结果:可以直接导出 .xls 表格。
    .xls

  • 隐藏/显示图表区:用于把一段时间内的数值变化用曲线图直观展示出来,另外还可以通过图表旁的四个设置按钮来缩放、还原、刷新、下载图表。
    图表

  • 自动刷新消息:勾选上这一栏,数据则自动在页面刷新,适合实时观察数据变化。
    自动刷新

  • 数据表格区:显示 Topic、消息内容和时间。
    数据表格

提示
如果当前消息内容是连续数值,例如温度、湿度、光照、电压等,那么图表功能会非常直观;如果消息内容是 ON、OFF 这类控制指令,则更适合以表格记录为主。

1.3.2 清空消息

点击该项可以删除该设备已有的消息记录。

清空 已清空

1.3.3 删除设备

删除当前设备及其关联记录。

删除设备 已删除

1.3.4 添加备注

为设备添加或修改说明信息。

添加备注 添加备注

1.4 发送消息

“发送消息”页面是最方便的远程调试入口之一。
发送消息

你可以在这里:

  • 手动填写 Topic

  • 输入一段测试消息

  • 验证设备是否能收到控制指令

常见测试内容可使用 ON、OFF 等远程控制指令。
发送消息on
发送消息off

从当前界面来看,这一页主要包括:

  • 主题(项目ID/设备名) 输入框:填写要发送到哪个 Topic,通常建议写成 项目名/设备名

  • 消息 输入框:填写要发送的具体内容,例如 ON、OFF、1、hello

  • 发送 按钮:将当前消息立即发送到对应 Topic

界面中的提示还说明了一个很实用的规则:

  • 如果给消息内容加上前缀 ->,这条消息会被视为“纯指令消息”

  • 这类消息不会被存入数据库

  • 例如 ->off 可以用于只控制、不留历史记录的场景

如果是第一次调试,建议先从简单的英文指令开始,例如 ON、OFF,这样更容易和设备端程序中的条件判断对应起来。

2. SIoT V2 界面介绍

和 SIoT V1 相比,SIoT V2 的页面结构更简洁,核心围绕 Topic 直接展开,适合快速完成“新建主题、发送数据、查看记录、导出数据”这一整套操作。

2.1 登录界面

登录页的结构比较直观,主要是下面几个位置:

  • 账号 输入框:填写登录用户名,默认通常为 siot

  • 密码 输入框:填写登录密码,默认通常为 dfrobot

  • 登录 按钮:提交账号信息并进入管理页面

  • 查看使用教程及常见问题:可作为首次使用时的辅助入口

SIoT V2 的登录页视觉风格比 V1 更现代化,适合在课堂演示时直接作为平台首页展示。
v2登陆界面

2.2 数据管理

登录后,通常先进入“数据管理”页面。

这一页是 SIoT V2 中最核心的页面,用来统一管理当前平台中的各个 Topic。如果把 V1 理解成“项目 + 设备”的组织方式,那么 V2 更适合理解成“按主题直接管理数据”。

已有主题时的页面状态
已有主题时的页面状态示意图

当系统中已经存在主题时,这一页通常包括:

  • 顶部标题区:显示当前所在页面为 数据管理

  • 新建主题(Topic) 卡片:用于继续新增主题

  • 主题信息卡片:显示每个 Topic 的基础信息

  • 操作区:对单个 Topic 执行查看详情、清空数据、删除等操作

  • 右上角工具区:包括搜索图标和退出登录入口

每张主题卡片中,通常可以看到以下信息:

  • 主题(topic):当前主题名称,例如 siot/led、siot/temp

  • 主题描述:用于补充说明这个 Topic 的用途

  • 数据总数:当前主题累计保存的数据条数

  • 最新数据:最近一次收到的数据内容

  • 数据时间:最近一次数据的时间

对于初学者来说,可以先把这里理解成“主题总目录页”。先看到有哪些 Topic,再决定进入哪一个 Topic 查看详细数据。

还没有主题时的页面状态
还没有主题时的页面状态示意图

如果当前平台中还没有任何主题,页面上通常只会看到一个明显的 新建主题(Topic) 卡片。

2.3 新建主题

在 SIoT V2 中,如果希望更清晰地管理数据,通常可以先在 Web 页面中手动新建主题。
新建主题示意图

点击 新建主题(Topic) 后,会弹出一个新建窗口,主要包括:

  • 主题名称:填写设备名称,例如 temp

  • 描述:填写这个 Topic 的用途说明

  • 取消 按钮:关闭当前窗口,不保存

  • 确定 按钮:确认创建主题

这里建议继续沿用前文一致的命名习惯,例如设备名使用 temp、led 这类简洁英文;创建完成后,平台会自动生成 siot/temp、siot/led 这样的完整 Topic。

如果是在课堂上使用,建议让学生把主题名称取得简洁、清晰、可辨认,这样后续在查看数据、做可视化绑定或排错时都会更方便。

这里还需要特别说明 SIoT V1 和 SIoT V2 在 Topic 命名方式上的一个重要区别:

  • 在 SIoT V1 中,Topic 通常由程序端创建,常见写法是 项目名/设备名

  • 在 SIoT V2 中,主题通常直接在 Web 管理界面中创建

  • 创建时输入的其实是“设备名称”这一部分,例如 temp

创建完成后,平台会自动生成完整的 Topic 名称,例如 siot/temp。

其中:

  • siot 表示项目名称,在 SIoT V2 中这一部分由平台固定生成,不能自定义

  • temp 表示设备名称,这一部分由用户自己填写,可以根据实际用途命名

因此,在 SIoT V2 中创建主题时,可以先把它理解成“给设备命名”;真正用于通信的完整 Topic,会由平台自动补成 siot/设备名 这种形式。

新建主题示意图2

2.4 查看详情

点击某个主题卡片中的 查看详情 后,就会进入该 Topic 的数据查看页面。

查看详情示意图

这一页通常是 SIoT V2 中最常用的页面之一,它把“发送测试消息”“查看历史记录”“查询时间范围”“导出数据”这些动作都集中到了同一个界面里。

从当前界面来看,这一页通常包括:

  • 返回 按钮:回到数据管理首页

  • 当前主题:显示当前正在查看的是哪一个 Topic

  • 消息内容 输入框:填写要发送到当前 Topic 的测试消息

  • 发送 按钮:立即发送当前消息

  • 保存到数据库 选项:决定这条消息是否作为记录保存

  • 开始时间 与 结束时间:用于筛选某个时间段内的数据

  • 条数选择:设置本次查询显示的数据数量,例如 100条

  • 查询 按钮:按当前条件筛选数据

  • 导出数据 按钮:将当前查询结果导出

  • 自动刷新:适合实时观察消息变化

  • 数据表格区:显示时间、消息内容以及删除数据等相关操作

如果你是第一次排错,建议优先用这一步确认三件事:

  • 设备有没有真的把数据发到这个 Topic

  • 发送的消息内容是不是你预期的格式

  • 平台能不能持续收到后续数据

2.5 清空数据

如果某个 Topic 中积累了很多历史记录,而你只想重新开始一次新的测试,可以使用 清空数据 功能。
清空数据示意图

点击 清空数据 后,系统会弹出确认窗口,常见按钮包括:

  • 取消:放弃本次操作

  • 确定:确认清空当前主题下已有的数据记录

这个功能适合用在下面几类场景中:

  • 课堂演示前,先清掉旧数据

  • 同一个 Topic 要重新做一次完整实验

  • 避免旧数据影响当前观察结果

需要注意的是,清空数据通常意味着当前主题下已有记录会被删除,因此在正式清理前,建议先确认是否已经导出或记录了需要保留的数据。

2.6 删除主题

如果某个 Topic 不再需要继续使用,也可以直接删除整个主题。
删除主题示意图

点击 删除 后,系统会弹出确认窗口,常见按钮包括:

  • 取消:放弃删除

  • 确定:确认删除当前主题

这一操作更适合用在下面几类情况:

  • 主题名称创建错了,需要重新建立

  • 某个实验已经结束,不再需要保留这个 Topic

  • 平台中有很多临时测试主题,需要做整理

和 清空数据 相比,删除主题 的影响更大,因为它不仅会移除数据,还会把这个 Topic 本身从主题列表中移除。

主控板接入指南

主控 编程语言 编程软件 Mind+ 编程模式 项目案例
行空板 M10 Python
图形化编程
Mind+ V2 Python 代码模式、
Python 积木模式
行空板 M10 连接 SIoT 的使用教程
行空板 K10 MicroPython
图形化编程
Mind+ V2 上传模式
MicroPython 代码模式
MicroPython 积木模式
行空板 K10 连接 SIoT 的使用教程
micro:bit 图形化编程 Mind+ V2 上传模式
Arduino Arduino C
图形化编程
Mind+ V2
Arduino IDE
上传模式
掌控板 图形化编程 Mind+ V2 上传模式
MicroPython 代码模式
MicroPython 积木模式

项目资源合集

以下链接主要根据 DFRobot 官网 可进入的官方资源站整理,优先收录与 SIoT 直接相关,或适合迁移到 SIoT 场景中的官方教程与项目页。

1. 行空板 M10

2. 行空板 K10

3. micro:bit

4. Arduino

5. 掌控板

进阶使用

1. 启动 SIoT(其他系统)

1.1 macOS 系统

双击运行对应文件,或打开终端进入 SIoT 所在目录后执行启动命令,例如:

./SIoT_mac64_1_2
macOS 系统示意图

重要警告
如果提示“没有权限”或“无法打开”,需要先为文件添加执行权限。

添加执行权限命令:

chmod a+x ./SIoT_mac64_1_2

如果担心终端关闭后程序被中止,可以使用 nohup 命令后台运行:

nohup ./SIoT_mac64_1_2 &

1.2 Linux 系统

SIoT 支持在 Linux 系统及树莓派、虚谷号等开源硬件设备上运行。打开终端进入 SIoT 所在目录后,先为启动文件添加执行权限:

chmod a+x ./SIoT_linux

然后执行启动命令:

nohup ./SIoT_linux &

其中 ./SIoT_linux 为 SIoT 程序所在路径。不建议直接为整个目录开放所有权限,以免带来不必要的安全风险。

2. 升级行空板 M10 内置 SIoT V1 到 V2

如果行空板 M10 的系统版本低于 v0.4.0,系统内置的通常是 SIoT V1,没有版本切换功能。这种情况下,如果你需要使用 Mind+ 数据可视化面板或新版 SIoT 功能,就需要先把行空板内置 SIoT 升级到 SIoT V2。

2.1 适用场景

这一方法适用于:

  • 行空板 M10 系统版本较低

  • 本地 Web 菜单中看不到 SIoT V1 / V2 切换选项

  • 需要在行空板上运行 SIoT V2

2.2 升级前准备

开始之前请先确认:

  • 已安装 Mind+

  • 行空板 M10 可以正常连接电脑

  • 电脑和行空板连接正常,能够打开远程终端

  • 已下载升级工程文件 升级行空板SIoT V2.mp

2.3 升级步骤

  1. 下载升级工程文件 升级行空板SIoT V2.mp。
升级示意图
  1. 打开 Mind+,在“打开项目”中打开刚下载的 升级行空板SIoT V2.mp 文件。
    升级示意图2

  2. 使用 USB 连接行空板 M10,并等待行空板启动完成。
    85

  3. 在 Mind+ 中点击“连接远程终端”,选择 10.1.2.3 连接行空板,连接成功后,点击“运行”。

86 87
  1. 等待行空板自动重启并完成升级。
    88

2.4 升级完成后的检查

升级完成后,可以按下面的方法确认是否已经成功切换到 SIoT V2:

  1. 打开行空板上的 SIoT 网页。

  2. 在浏览器中按 Ctrl + F5 强制刷新页面缓存。

  3. 查看网页界面是否已经变为新版 SIoT V2。

2.5 说明与建议

  • 如果刷新后看到的仍然是旧版界面,优先尝试强制刷新缓存。

  • 如果 Mind+ 无法连接 10.1.2.3,需要先检查 USB 连接和远程终端连接状态。

  • 如果你的行空板系统版本已经在 v0.4.0 及以上,通常优先使用系统内置的版本切换方式,不必再用这个升级方法。

常见问题

1. SIoT 无法访问怎么办

常见现象包括:

  • 浏览器打不开 http://IP:8080

  • 主控板已经连上 Wi-Fi,但 MQTT 连接不上

  • 局域网中的其他设备无法访问 SIoT 页面
    SIoT 无法访问怎么办示意图

建议按下面顺序排查:

  1. 确认运行 SIoT 的设备和主控板处在同一局域网中。

  2. 确认 SIoT 服务已经真正启动,而且启动窗口没有被关闭。

  3. 在浏览器中访问 http://IP:8080,检查网页能否打开。

  4. 如果网页打不开,重新确认当前局域网 IP 是否发生了变化。

  5. 如果网页能打开,但主控板仍然连不上,再检查服务器地址、用户名、密码、端口和 Topic 是否填写正确。

如果启动窗口中提示“账号或密码错误”,通常说明当前 Mind+ 版本异常或过旧,建议改用官网提供的最新版重新安装。

2. 主控板无法连接服务器

如果主控板能连上 Wi-Fi,但就是连不上 SIoT,通常优先检查:

  • 主控板是否已经连接到和服务器相同的 Wi-Fi

  • 服务器地址是否填写为运行 SIoT 设备的实际局域网 IP

  • 用户名和密码是否仍为当前平台设置值

  • MQTT 端口是否仍为 1883

  • Topic 写法是否符合当前版本要求

其中要特别注意:

  • SIoT V1 常见 Topic 写法为 项目名/设备名

  • SIoT V2 在平台中创建主题后,实际使用的完整 Topic 通常为 siot/设备名

3. 能连接但看不到消息

如果程序显示连接成功,但 Web 页面中看不到消息,优先检查:

  • Topic 是否写错

  • 发送端和接收端是否真的使用了同一个 Topic

  • 程序是否真的执行到了发送语句

  • 发送频率是否过快,导致你没有及时观察到结果

  • SIoT V2 中发送测试消息时,是否勾选了 保存到数据库

如果是第一次排错,建议先发送一条最简单的测试消息,例如 hello 或 1,再回到 Web 页面观察是否出现记录。

4. 其他设备能否访问本机 SIoT

如果本机能打开 SIoT,但手机、平板或其他电脑打不开,通常要重点检查 Windows 防火墙。

建议先用同一局域网中的手机访问运行 SIoT 的电脑地址。如果手机也打不开,往往就说明不是主控板程序问题,而是电脑阻止了外部设备访问。

处理方法通常是:

  1. 打开 控制面板

  2. 进入 系统和安全 > Windows Defender 防火墙

  3. 打开 允许应用或功能通过 Windows Defender 防火墙

  4. 将 SIoT 对应程序加入允许列表

  5. 建议将可见的网络访问选项都勾选上
    SIoT 无法访问怎么办示意图

如果只是临时排查,也可以短时间关闭防火墙测试:

如果关闭防火墙后局域网设备可以正常访问,就基本可以确定问题出在防火墙拦截。
其他设备能否访问本机 SIoT示意图

详细图文可参考:无法连接 SIoT 的解决方法。

如以上均正常,则可能是主控板 Wi-Fi 模块存在故障,可以尝试更换主控板测试,或加入 Mind+ 官方交流群继续交流。

5. 消息发了但设备没反应

如果 Web 页面已经发出了消息,但设备端没有执行动作,优先检查:

  • 设备是否订阅了相同 Topic

  • 接收回调是否写对

  • 收到消息后是否真的执行了控制逻辑

  • 控制值大小写是否一致,例如 ON 和 on

  • 设备端程序中是否把收到的数据正确转换成字符串再判断

这一类问题最适合先用最简单的 ON / OFF 或 1 / 0 指令排查。

6. 运行 Python 代码报错 Unsupported callback API version 怎么办

如果运行 Python 版本的 siot 库示例时,出现下面这类报错:

raise ValueError: Unsupported callback API version
python报错

通常是因为 paho-mqtt 安装成了过新的版本,而当前 siot 库示例依赖的是兼容版本。

可按下面顺序处理:

  1. 卸载 paho-mqtt

  2. 将 siot 库升级到最新版本

  3. 再重新安装或运行示例

常见命令如下:

pip uninstall paho-mqtt
pip install -U siot

这样通常会自动重新安装兼容版本的依赖库,之后即可恢复正常。

提示
标准 Python 连接示例:
如果您想在电脑上使用 Python 直接连接 SIoT 平台(支持 V1/V2,且已兼容不同版本的 paho-mqtt 库,避免出现 Unsupported callback API version 报错),可以参考我们提供的 siot_python_demo.py 脚本,该脚本中包含完整的连接、订阅、发布和回调逻辑。

7. 可以自己搭建本地 SIoT 服务器吗

可以。

如果你不希望长期依赖 Windows 电脑运行 SIoT,或者经常受到防火墙影响,可以考虑把 SIoT 部署到下面这类设备上:

  • 行空板

  • 树莓派

树莓派上搭建 SIoT 服务器的方法可参考:树莓派上搭建 SIoT 服务器的方法

这类方式更适合长期运行、展台展示和多设备同时接入的场景。

8. 公网可以访问 SIoT 吗

可以,但通常不建议初学阶段一开始就这样做。

常见实现方式包括:

如果只是课堂或校园网内实验,通常优先在局域网场景下完成即可;等本地链路稳定后,再考虑公网访问。

9. 打开 SIoT V2 网页提示“APP 被禁用”怎么办

app禁用

这种情况通常出现在:

  • 使用了较旧版本的 SIoT V2

  • 本地页面资源没有更新完全

  • 浏览器仍然缓存着旧版页面文件

处理建议是:

  1. 先升级到较新的 SIoT V2 版本

  2. 再重新打开浏览器页面

  3. 按 Ctrl + F5 强制刷新缓存

参考教程:打开 SIoT V2 网页显示“APP 被您禁用了”怎么办?

如果升级后仍然异常,可以关闭页面后重新启动 SIoT,再重新访问一次。

10. 运行 SIoT 时网页排版错乱、样式丢失或部分功能失效怎么办

常见现象包括:

  • 页面变成纯文本样式

  • 登录页布局错乱

  • 按钮、颜色或背景样式丢失

排版错乱 排版错乱2

这种问题通常不是 SIoT 本身坏了,而是 Windows 系统把 .css 或 .js 文件错误识别成了普通文本,导致浏览器出于安全策略拦截了这些页面资源。

提示
快捷修复方法:
为了方便教师和学生快速修复该问题,我们已在 辅助代码 文件夹中提供了 修复网页排版错乱.reg 一键修复脚本。
您只需双击运行该 .reg 文件,并在系统弹窗中确认允许合并,随后重启浏览器并按下 Ctrl + F5 强制刷新缓存即可恢复。

手动修复步骤(如果快捷方法失效或在非管理员权限下运行):

  1. 按下键盘上的 Win + R 键,输入 regedit 并回车,打开注册表编辑器。

  2. 在左侧目录树中向下滑动,找到并点击 HKEY_CLASSES_ROOT\.css 文件夹。

  3. 在右侧窗口找到名为 Content Type 的项(如果没有,右键新建 -> 字符串值,命名为 Content Type)。

  4. 双击打开 Content Type,将数值数据修改为 text/css 并确定。

  5. 同样地,在左侧目录找到 HKEY_CLASSES_ROOT\.js。

  6. 双击其右侧的 Content Type,将数值数据修改为 application/javascript 并确定。

  7. 关闭注册表编辑器,重启 SIoT 软件。

  8. 在浏览器中按下 Ctrl + F5 强制刷新刚才异常的页面,即可恢复正常。

修复后,页面通常会恢复为正常样式。

11. SIoT 管理页面可以修改吗?可以增加按钮吗

可以,但这已经属于进阶使用范围,参考教程见链接:为 SIoT 写一个物联网设备管理插件

如果你希望:

  • 修改页面布局

  • 增加自定义按钮

  • 做更贴合课堂项目的专用界面

就需要进一步了解 SIoT 的页面文件结构或二次开发方式。对于大多数教学场景,建议先把“能稳定连接、能看到数据、能完成控制”这三件事跑通,再考虑界面层的定制。

12. 排错顺序建议

最省时间的排错顺序通常是:

  1. 先确认 SIoT 服务是否在运行。

  2. 再确认网络是否互通。

  3. 再确认 Topic、用户名、密码、端口。

  4. 再用 Web 页面或 MQTT 工具做最小测试。

  5. 最后才回头检查主控板程序。

这样能避免一开始就在复杂程序里盲目找问题。

13. 调试工具建议

在给掌控板、Arduino 或其他终端写物联网程序前,可以先用另一台电脑或手机上的 MQTT 调试工具测试服务器是否正常,这样能快速分离“服务器问题”和“设备程序问题”。

14.页面缓存说明

如果你已经升级到 SIoT V2 ,但浏览器打开后看到的仍然像旧版页面,通常是浏览器缓存导致的。
此时建议按:Ctrl + F5 强制刷新页面缓存,再重新查看。

更新日志

  • v1.0.0:完成 SIoT Wiki 初版内容整理。